home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / tin-1.22 / INSTALL.NNTP < prev    next >
Encoding:
Text File  |  1995-07-14  |  3.3 KB  |  91 lines
  1. Compilation and installation notes for NNTP patches - 18-11-92
  2. --------------------------------------------------------------
  3.  
  4. This document explains the install procedure for the supplied patch to the
  5. NNTP server nntpd & to the TIN newsreader to retrieve index files from the
  6. NNTP server. 
  7.  
  8. NNTP server
  9. -----------
  10. 1) Copy the following files to <nntp-source-dir>/server
  11.      cp xindex.c <nntp-source-dir>/server
  12.      cp xmotd.c <nntp-source-dir>/server
  13.      cp xuser.c <nntp-source-dir>/server
  14.  
  15. 2) Copy the following files to <nntp-source-dir>
  16.      cp server.patch <nntp-source-dir>
  17.      cp common.patch <nntp-source-dir>
  18.  
  19. 3) Patch the files in <nntp-source-dir>/common & <nntp-source-dir>/server
  20.      cd <nntp-source-dir>
  21.      patch < common.patch
  22.      patch < server.patch
  23.  
  24. 4) Copy <nntp-source-dir>/common/conf.h.dist to <nntp-source-dir>/common/conf.h
  25.      cd <nntp-source-dir>/common
  26.      cp conf.h.dist conf.h
  27.  
  28. 5) Edit <nntp-source-dir>/common/conf.h to suit your sites needs. 
  29.    The XINDEX, XMOTD, XOVERVIEW & XUSER extensions are #defined by 
  30.    default. You may need to change the path for the #define's for 
  31.    XINDEX_DIR, XMOTD_FILE & SUBSCRIBTIONS_FILE. 
  32.    The default for XINDEX_DIR is /usr/spool/news/.index and for the
  33.    others /usr/lib/news/[motd | subscriptions]
  34.      cd <nntp-source-dir>/common
  35.      [vi|emacs] conf.h
  36.  
  37. 6) Recompile & install the NNTP server nntpd
  38.      cd  <nntp-source-dir>
  39.      make server
  40.      make install_server
  41.  
  42. TIN client
  43. ----------
  44. 1) Nothing needs to changed in the tin client as long as you originally
  45.    compiled tin with -DNNTP_ABLE or -DNNTP_ONLY. You will have to remove
  46.    -DDONT_HAVE_NNTP_EXTS from the CFLAGS in the Makefile and recompile
  47.    if it was originally defined.
  48.  
  49. 2) Recompile & install tin.
  50.      cd <tin-dir>
  51.      make <system>
  52.      make install
  53.  
  54. TIN daemon (on NNTP server)
  55. ---------------------------
  56. 1) Edit tin Makefile to enable index daemon functionality.
  57.      cd <tin-dir>
  58.      [vi|emacs] Makefile
  59.      Add -DINDEX_DAEMON to CFLAGS to create a version of tin 'tind' to
  60.      create & update index files on the NNTP server.
  61.  
  62. 2) Compile & install tind.
  63.      cd <tin-dir>
  64.      make <system>
  65.      make install_daemon
  66.  
  67. 3) Add entry to crontab to start 'tind' index daemon every so often.
  68.      cd /usr/spool/cron/crontabs
  69.      [vi|emacs] root
  70.      Add following line to run tind every 30 minutes: 
  71.        0,30 * * * * su news -c '/usr/lib/news/tind'
  72.  
  73. OK. If you have gotten this far you will have the following configuration:
  74.   o  tind will run every 30 minutes to update a central directory (usually
  75.      /usr/spool/news/.index) of tin index files for all groups in the active
  76.      file. The directory can be changed by 'tind -I dir' if so desired.
  77.  
  78.   o  The NNTP server nntpd will service all requests for tin index files
  79.      from tin clients. It will do this by returning the contents of the
  80.      group index file in the index directory (ie. /usr/spool/news/.index/*)
  81.  
  82.   o  The tin client will issue requests for index files to the NNTP server
  83.      therefore saving space on the client machine and ensuring that there
  84.      are only one copy of index files on the whole network.  Also clients
  85.      will not have to wait while index files are built locally as the index
  86.      daemon tind runs frequently on the news server.
  87.              
  88. Enjoy & happy newsreading
  89.  
  90. Iain
  91.